home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / stdump.z / stdump
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  93 lines
  1. STDUMP(1)                                              Last changed: 1-4-99
  2.  
  3.  
  4. NNAAMMEE
  5.      ssttdduummpp - Dumps a file of intermediate-code debugging information
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ssttdduummpp [--aa] [--bb] [--cc] [--gg] [--hh] [--ii] [--nn _n_u_m_b_e_r] _f_i_l_e
  9.  
  10. IIMMPPLLEEMMEENNTTAATTIIOONN
  11.      IRIX systems
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      When compiling for the old 32-bit ABI (--3322), the compilers generate an
  15.      intermediate language which is separated into binary instructions and
  16.      debugging information, each constituting a separate file.  Use ssttdduummpp
  17.      to dump a file containing debugging information which was generated by
  18.      the compilers.  ssttdduummpp writes to the standard output.  The
  19.      organization of the output is simple but the details of the output are
  20.      complicated.  The detailed output is be defined here.  The output of
  21.      ssttdduummpp is subject to change and one should not rely on the output
  22.      format remaining the same from release to release.
  23.  
  24.      The organization of the output is that for each source file
  25.      represented in _f_i_l_e, there may be auxiliary-symbols, local-symbols, a
  26.      file-indirect-table, optimization-entries, procedures, and line-
  27.      numbers.  There is only one externals-table and one dense-number-table
  28.      in _f_i_l_e.
  29.  
  30.      By default, ssttdduummpp prints all information about all sections of the
  31.      debugging information.  The options (described on this man page)
  32.      restrict the output to the selected sections.
  33.  
  34.      The _f_i_l_e may be an object file (such as produced by cccc --cc), an
  35.      executable file (such as produced by lldd(1) or cccc(1)), or a debugging
  36.      information file (which may be produced as described below).
  37.  
  38.      Normally, debugging information files (and instruction files) are
  39.      placed in //ttmmpp and removed after each compilation.  Use the --kkeeeepp
  40.      option to cccc, or ff7777(1), to force the compiler to preserve these files
  41.      in the target directory.  When this switch is used, the compilation of
  42.      ffiillee.._x (where _x is c for C or f for FORTRAN, for example) will produce
  43.      the intermediate files ffiillee.._B (instructions) and ffiillee.._T (debugging
  44.      information).  The latter file (ffiillee.._T)) mmaayy bbee uusseedd aass iinnppuutt ttoo
  45.      ssttdduummpp..
  46.  
  47.      ssttdduummpp accepts the following options:
  48.  
  49.      --aa      Print the dense number table.  This section is empty for
  50.              object and executable files.
  51.  
  52.      --bb      Print the externals table.
  53.  
  54.      --cc      Print the local debugging symbols.  The source file name is
  55.              printed here.
  56.  
  57.      --gg      Print the auxiliaries table.  This table has encoded in it in
  58.              a complex way the actual data types of all the data in the
  59.              symbols.  The local-symbol and externals table sections show
  60.              this data expanded into semi-readable text.
  61.  
  62.      --hh      Print the line table.  One source line number per 32-bits of
  63.              executable code.
  64.  
  65.      --ii      Print the File Indirect Table.
  66.  
  67.      --nn _n_u_m_b_e_r
  68.              Print information about only the source file whose number is
  69.              specified.  Files are numbered sequentially starting with
  70.              zero.
  71.  
  72. FFIILLEESS
  73.      //ttmmpp//ccttmmssttaa_x_x_x_x_x Default name of debugging information file for
  74.                       process id _x_x_x_x_x
  75.  
  76.      _f_i_l_e..TT           Name of debugging information file created by the
  77.                       --kkeeeepp option
  78.  
  79.      //uussrr//bbiinn//ssttdduummpp  Debugging information dump program
  80.  
  81. SSEEEE AALLSSOO
  82.      eellffdduummpp(1), ddwwaarrffdduummpp(1), cccc(1), ff7777(1), ppcc(1), aabbii((55))
  83.  
  84. NNOOTTEESS
  85.      Do not use ssttdduummpp to display the debugging information of 64-bit (--6644)
  86.      or new 32-bit ABI (--nn3322) object files.  Use the ddwwaarrffdduummpp(1) command
  87.      instead.
  88.  
  89.      To see the linking information, specify eellffdduummpp(1) instead of ssttdduummpp.
  90.  
  91.      This man page is available only online.
  92.  
  93.